home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 1 / Cream of the Crop 1.iso / SOUND / PLAY400.ARJ / PLAY.DOC < prev    next >
Text File  |  1991-02-09  |  10KB  |  264 lines
  1.              _ __    _    __   _    ,
  2.             ' )  ) _//   /  ) ' )  /    Sound Sample Editing
  3.              /--'  /    /--/   /  /     Software for the IBM
  4.             /     /___ /  (_  (__/_     PCs useless speaker!
  5.                                //
  6.              Version 4.00     (/        (C) Mark J Cox 1990
  7.  
  8. _____________________________________________________________________________
  9.  
  10.             New Version Documentation
  11.  
  12.                         See file WHAT-NEW.400
  13. _____________________________________________________________________________
  14.  
  15. PUBLIC DOMAIN - FREEWARE
  16. ------------------------
  17.  
  18.      This document provides brief instructions into the use of the PLAY
  19.      sound sample replaying software. This is therefore not a demo version
  20.      and is not disabled in any way.
  21.  
  22.      Why did I make it FREEWARE (I've had a couple of offers from
  23.      software companies for this!)? Well, because I'm a student and
  24.      hate software that I have to pay for, then find it is useless or
  25.      I could have written better... Shareware is a bit better, letting
  26.      you evaluate the package - but it's still a costly business.. By
  27.      making this software totally free I hope more people will enjoy
  28.      it and feel free to distribute it to friends!
  29.  
  30. WHAT DOES IT DO?
  31. ----------------
  32.  
  33.      PLAY allows you to play and edit sound samples from a variety of machines,
  34.      AMIGA,ATARI ST and MAC samples have been played with great sucess through 
  35.      the internal speaker.  It has a few 'fancy' features as well!
  36.  
  37. WHAT DO I NEED?
  38. ---------------
  39.  
  40.      To simply play a sample from start to finish, Nothing more than the
  41.      play.com file and the sound sample file
  42.      ....any machine should do as long as it has a decent sized speaker and
  43.      MSDOS 3.00 or above (an 80286+ would be preferable)
  44.  
  45.      If you have VGA graphics and a MOUSE installed the fun starts, allowing you
  46.      to look at the waveform and play bits of it - alter frequencies and do all
  47.      sorts of wierd and wonderful things.
  48.  
  49. HOW DO I RUN IT?
  50. ----------------
  51.  
  52.      If you have VGA and a MOUSE driver installed just type
  53.  
  54. C:\> PLAY
  55.  
  56.      Otherwise type
  57.  
  58. C:\> PLAY /?
  59.  
  60.      to get a list of the things you can do from the command line.
  61.  
  62. WHATS THIS HARDWARE THEN?
  63. -------------------------
  64.  
  65.      By addition of a piece of hardware costing around 20 quid (to build) onto a
  66.      spare printer port you can sample your own sounds and replay them through
  67.      your hi-fi with really astonishing quality.  
  68.  
  69. HOW CAN I GET A CIRCUIT DIAGRAM?
  70. --------------------------------
  71.  
  72.      For a modest sum, I will send two 3.5" (Branded) High Density disks with
  73.      the latest version of PLAY and RESPLAY together with nicely printed
  74.      instructions and a copy of the circuit diagram.  To obtain this
  75.      package, send 10 pounds (sterling!) to the address at the end
  76.      of this document!  I make a little profit on each, but that will help
  77.      to cover the cost of the book I had to buy to improve my VGA routines!
  78.  
  79. HOW LONG A SAMPLE CAN I STORE?
  80. ------------------------------
  81.  
  82.      It depends on what frequency the sample is and how much memory is free -
  83.      at 16kHz (the speed I like to sample at) I get about 33 seconds into
  84.      memory with no TSRs except a Disk Cache - I have a mac sample at 11kHz
  85.      of the entire Dr. Who. theme tune;  Sorry, until I fathom how
  86.      to use Extended/Expanded memory it can't use it! (Well, I've now worked
  87.      out how to use it, just I can't get it to work!)
  88.  
  89. DOES IT CRASH?
  90. --------------
  91.  
  92.      Yes! It doesn't like programmes like DesqView - or any sort
  93.      of shell you run it from.  Run it from DOS with no TSR's for
  94.      best performance.. If the Interactive version crashes, try using
  95.      it from the command line.
  96.  
  97. ______________________________________________________________________________
  98.  
  99.             INSTRUCTIONS FOR USE
  100.             ====================
  101.  
  102.  
  103. PLAY FROM THE COMMAND LINE!
  104. ---------------------------
  105.  
  106.      Usage: PLAY [-k<nn>] [-options] [<filename>]
  107.  
  108.        -k<nn> = Select Play/Record speed in kHz (default 16kHz)
  109.                 (in range 05...39)
  110.  
  111.      Options: (more are displayed if you do PLAY/?)
  112.  
  113.        -s     = Play sample named through PCs speaker (Lo-Fi)
  114.  
  115.      Example:
  116.  
  117. play -smarvin.smp          - Plays the file test.smp at 16kHz
  118. play -k05 -sa:marvin.smp   - Plays the file test.smp at 5kHz from A:
  119.                              (note leading zero required)
  120.  
  121.      When sample has loaded it will automatically start playing and
  122.      can be stopped by pressing any key (and I mean ANY key!!)
  123.  
  124.      There are a few other options such as recording from the command
  125.      line and setting which port the hardware is connected to and
  126.      doing echo's and things - but you need not worry too much about
  127.      them until Version 4.00!
  128.  
  129. INTERACTIVE PLAY!
  130. -----------------
  131.  
  132.      Usage: PLAY (or PLAY /I)
  133.  
  134.      (Useful hint: PLAY /k11/I will take you into interactive mode
  135.       with the frequency set to 11kHz etc... lets you create a batch
  136.       file that loads PLAY with some default values - you can also
  137.       do things like PLAY /k11 /l1 /i to set the port default as well)
  138.  
  139.      If VGA board is installed then programme will show initial
  140.      screen. Although all commands can be acessed from the
  141.      keyboard, I'm afraid you will need a mouse + driver
  142.      installed due to a wierd bug I'm working on! (You can
  143.      operate it entirely from the keyboard you see)
  144.  
  145.      The screen is divided into 3 areas, the top line contains some
  146.      buttons giving information on the program.  Left Click on any
  147.      button to do that command, Right Click to get help on that
  148.      command
  149.  
  150.      The next bit is a graph of the current sample.
  151.  
  152.      The bottom section contains more buttons with lots of
  153.      features!
  154.  
  155.      The (blue) pointers can be moved by picking them up with the mouse,
  156.      or by using the control 'hot-spots' either side of the little
  157.      number indicators.  The numbers give the time in Seconds at which
  158.      the pointer is pointing.
  159.  
  160.      The middle number and surrounding 'hot-spots' is the frequency in
  161.      kHz and this can be altered in 0.25 kHz steps or you can jump to
  162.      11kHz,16kHz or 22kHz directly.
  163.  
  164.      The various commands are not explained here, help can be got
  165.      by holding down the right mouse key when you are over a
  166.      button.
  167.  
  168. Note: CUT/COPY/PASTE rely on a temporary file c:\play.cut, if you
  169.       don't have a hard drive you cant use these commands (sorry,
  170.       but it's too slow off a floppy - I'll let you change the
  171.       default in a later version so you can make it store on a
  172.       high-memory Ram Drive or something)
  173.  
  174. MUSHROOMS?
  175. ----------
  176.  
  177.       Even your favourite Mushroom and Mood samples can be played. Just
  178.       load in, select 'Shift Left' function twice, then take the frequency
  179.       down to 10kHz and BINGO! Not the best sound in the world but its a
  180.       bit better than the distributed player (and you get to fiddle with
  181.       the sample+ it sounds SUPERB through the hardware!)
  182.  
  183. HEADERS
  184. -------
  185.     
  186.       Some sample files (MAC ones etc..) have small headers added to the
  187.       beginning of the file - if you play these as normal you will hear
  188.       a fraction of a second of noise before the sample starts -you could
  189.       always edit this out using the interactive version though!
  190.  
  191. FAVOURITE BBS
  192. -------------
  193.  
  194.      Try 'Kingdom of GREYHAWK' on Derby (0332) 756414 24hr for the latest
  195.      versions and lots and lots of samples - Don't forget to
  196.      mention PLAY when registering! (300...9600 baud)
  197.  
  198. MAIL ME?
  199. --------
  200.  
  201.      Please mail me about any bugs or future enchancements you
  202.      would like to see.  Leave a message on Greyhawk BBS
  203.      (2:250/404.5 if you use NetMail)
  204.      or "mjhc8@uk.ac.bradford.eeng" from any University/Poly etc.
  205.      (Normal Post does OK too, only a little slower! :-)
  206.  
  207. BUGS
  208. ----
  209.  
  210.      Known bugs are displayed when running the program interactively.
  211.      If you find others please let me know!
  212.  
  213. JARGON
  214. ------
  215.  
  216.      Now for the boring, legal jargon:
  217. _____________________________________________________________________________
  218.  
  219. Copyright/License/Warranty
  220. --------------------------
  221.  
  222. This document and the program file PLAY.COM ("the software") are
  223. copyrighted by the author.  The copyright owner hereby licenses
  224. you to: use the software; make as many copies of the program
  225. and documentation as you wish; give such copies to anyone; and
  226. distribute the software and documentation via electronic means.
  227. There is no charge for any of the above.
  228.  
  229. You are specifically prohibited from charging, or requesting
  230. donations, for any such copies, however made; and from
  231. distributing the software and/or documentation with commercial
  232. products without prior permission.
  233.  
  234. NO FOR-PROFIT ORGANIZATION IS AUTHORIZED TO CHARGE ANY AMOUNT
  235. FOR DISTRIBUTION OF COPIES OF THE SOFTWARE OR DOCUMENTATION,
  236. OR TO INCLUDE COPIES OF THE SOFTWARE OR DOCUMENTATION WITH SALES
  237. OF THEIR OWN PRODUCTS.
  238.  
  239. THIS INCLUDES A SPECIFIC PROHIBITION AGAINST FOR-PROFIT
  240. ORGANIZATIONS DISTRIBUTING THE SOFTWARE, EITHER ALONE OR WITH
  241. OTHER SOFTWARE, AND CHARGING A "HANDLING" OR "MATERIALS" FEE OR
  242. ANY OTHER SUCH FEE FOR THE DISTRIBUTION.  NO FOR-PROFIT
  243. ORGANIZATION IS AUTHORIZED TO INCLUDE THE SOFTWARE ON ANY MEDIA
  244. FOR WHICH MONEY IS CHARGED WITHOUT PRIOR PERMISSION FROM THE
  245. COPYRIGHT OWNER.
  246.  
  247. No copy of the software may be distributed or given away without
  248. this document; and this notice must not be removed.
  249.  
  250. There is no warranty of any kind, and the copyright owner is not
  251. liable for damages of any kind.  By using this free software,
  252. you agree to this.
  253.  
  254. The software and documentation are:
  255.  
  256.                    Copyright (C) 1990
  257.                    Mark J Cox
  258.                    29 Lundie Close
  259.                    Stenson Fields
  260.                    Derby
  261.                    DE2 3AN
  262.  
  263.  
  264.